Load a PIN Text String

Command:

Load a PIN text string.

Notes:

The default PIN text string, used by the HSM when printing PINs in words is initialised at Cold-Start to English (ONE, TWO, THREE, ....). The Load PIN Text String command can be used to re-define the text string which is then stored in battery-backed not tamper-protected memory.

When re-defining the text strings, strings for all characters (0 to 9) must be supplied.

The value for the length fields can be in the range 0,1,2,.... to F (Hex), with 0 representing length 16₁₀.

Field

Length & Type

Details

COMMAND MESSAGE

Message header

m A

(Subsequently returned to the Host unchanged).

Command code

2 A

Value LI.

Length

1 H

The length of the string for Character 0.

Character 0

n B

The text string representing Character 0.

Length

1 H

The length of the string for Character 1.

Character 1

n B

The text string representing Character 1.

Length

1 H

The length of the string for Character 2.

Character 2

n B

The text string representing Character 2.

Length

1 H

The length of the string for Character 3.

Character 9

n B

The text string representing Character 9.

End message delimiter

1 C

Optional. Must be present if a message trailer is present. Value X’19.

Message trailer

n A

Optional. Maximum length 32 characters.

RESPONSE MESSAGE

Message header

n A

Returned to the Host unchanged.

Response code

2 A

Value LJ.

Error code

2 N

00 : No errors

15 : Error in input data

End message delimiter

1 C

Present only if present in the command message. Value X’19.

Message trailer

n A

Present only if present in the command message. Maximum length 32 characters.